(C) 1996 AROS - The Amiga Replacement OS


NAME
#include <utility/tagitem.h>
#include <proto/utility.h>
struct TagItem * AllocateTagItems()
SYNOPSIS
ULONG numTags

LOCATION
In UtilityBase at offset 11
FUNCTION
Allocate a number of TagItems in an array for whatever you like. The memory allocated will be cleared.

INPUTS
numTags
The number of TagItems to allocate.
RESULT
A pointer to an array of struct TagItem containing numTags tags.

NOTES
The number you supply must include the terminating tag (ie TAG_DONE) There is no provision for extra TagItems at the end of the list.

If the number of tags to allocate is zero, then none will be.

EXAMPLE
struct TagItem *tagList;

tagList =  AllocateTagItems( 4 );

tagList[0].ti_Tag  = NA_Name;
tagList[0].ti_Data = (IPTR)"A list of tags";
tagList[3].ti_Tag  = TAG_DONE;

\* Do what you want with your TagList here ... *\

FreeTagItems( tagList );

BUGS
SEE ALSO
FreeTagsItems()
INTERNALS
HISTORY
27.01.1997 digulla
Added #include <proto/exec.h>
27.01.1997 ldp
Polish
10.12.1996 aros
Moved #include into first column to allow makedepend to see it.
24.10.1996 aros
Use proper Amiga datatypes (eg: ULONG not unsigned long)
24.10.1996 aros
Use the official AROS macros over the __AROS versions.
13.09.1996 digulla
Use IPTR
12.09.1996 digulla
Better way to separate public and private parts of the library base
31.08.1996 aros
Merged in/modified for FreeBSD.